home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / ljprt205.zip / LJPRINT.DOC next >
Text File  |  1992-10-08  |  25KB  |  459 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                           A Utility for HP's Laserjet II/III and Compatibles
  7.                       >> Print Up To Four Pages Of Text On One Sheet Of Paper <<
  8.                                                  v2.05
  9.  
  10.                                            (C)opyright 1992
  11.  
  12.                                                 Zenware
  13.                                             4795 Creaser Rd
  14.                                         Westmoreland N.Y. 13490
  15.  
  16.                                           All Rights Reserved
  17.  
  18.                                           DISTRIBUTION NOTICE
  19.  
  20.          This is "user-supported" software, it carries no warranties expressed or implied. It
  21.          is solely up to the  user to determine its suitability  for use on his/her  machine.
  22.          LJPRINT is made available on a 'try before you buy' basis. It is not crippled in any
  23.          way, and has no 'advertising'.  You may distribute this copy of LJPRINT.EXE  and its
  24.          documentation, subject to the following conditions:
  25.  
  26.                1.    LJPRINT.EXE may be distributed freely without charge.
  27.  
  28.                2.    LJPRINT.EXE  may not be sold, licensed, or a fee charged for its use. If
  29.                      a fee is charged in connection with LJPRINT.EXE, it must cover  the cost
  30.                      of  copying  or  dissemination  only.  Such   charges  must  be  clearly
  31.                      identified as such by the  originating party. Under no circumstances may
  32.                      the  purchaser be  given the  impression that  he is  buying LJPRINT.EXE
  33.                      itself.
  34.  
  35.                3.    LJPRINT.EXE  must  be  presented  as  a  complete unit,  including  this
  36.                      documentation. Neither LJPRINT.EXE nor its  documentation may be amended
  37.                      or altered in any way.
  38.  
  39.                4.    By granting you the  right to distribute LJPRINT.EXE, you  do not become
  40.                      the owner of LJPRINT.EXE in any form.
  41.  
  42.                Any  other use,  distribution or  representation of  LJPRINT.EXE  is expressly
  43.                forbidden without the written consent of ZenWare.
  44.  
  45.                Personal use license (U.S. funds)  is $10 which should be mailed  to the above
  46.                address if the program is used for a reasonable trial period (30 days). Please
  47.                use the registration form at the end of this document. Users who register will
  48.                receive the latest update when it becomes available.
  49.  
  50.                Corporate  users  must   contact  me  for  corporate  rate   or  site  license
  51.                arrangements.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                 Page 1
  62.          INTRODUCTION:
  63.  
  64.                This program  was written to  alleviate a minor  problem that I've  always had
  65.          when it came time to  print a listing for debugging, archiving, etc., i.e. excessive
  66.          amounts of  paper would be  wasted in generating  the hardcopy. The solution  was to
  67.          write  a simple  to  use program  for  the  Hewlett-Packard Laserjet  Series  II/III
  68.          printers that  would create a printed sheet holding a maximum of four pages of ASCII
  69.          text.
  70.  
  71.                The program comes with a set of defaults built into the executable code. These
  72.          defaults can be over-ridden  any time using command line options.  If desired, these
  73.          options can also be saved permanently within the body of the executable code.
  74.  
  75.          INSTALLATION:
  76.  
  77.                Copy the executable  to the desired drive  and directory. If you  ever foresee
  78.          making changes to the default settings, make sure that the path points to the  drive
  79.          and directory  containing the  program. To  invoke the  program, at  the DOS  prompt
  80.          enter:
  81.  
  82.                                    ljprint <option(s)> <source.fil>
  83.  
  84.                The screen in Figure 1 will appear if no arguments are given.
  85.  
  86.                If at  any time  you forget what  the options are,  entering the  program name
  87.          'LJPRINT', at the  DOS prompt and  with no  arguments, will bring  up a help  screen
  88.          showing  the  current  defaults  and  available options.  Multiple  options  can  be
  89.          specified on the command line.
  90.  
  91.          EXAMPLE:    LJPRINT +w +n file.doc +k +Pg:-12
  92.                The following options are active:
  93.                      do line wrap (+w)
  94.                      add line numbers (+n)
  95.                      delete file after printing (+k)
  96.                      print from start of file to max of page 12 or actual file size
  97.  
  98.                If the document that you are printing is formatted and has embedded formfeeds,
  99.          LJPRINT will output  the pages correctly if  the maximum number of  lines specified,
  100.          the '+L:xx'  option, is  greater than or  equal to the  line count for  the document
  101.          being printed.  A Ctrl-C (^C), Ctrl-Break (^Brk) or  ESC will terminate execution of
  102.          the program.
  103.  
  104.          OPTIONS:
  105.                The  filename (which can  contain wildcards) and  the various  options, can be
  106.                given in any order, however, all options are verified before  printing starts,
  107.                and all files are printed using the same settings.
  108.  
  109.          Output Port (+P:x):
  110.                Specify the port that is to receive the  file. If output to a file is desired,
  111.                than the use of the '+O' option is required. Only the port option can be saved
  112.                as a default. File output is available for each execution of the program only.
  113.                If file output is desired and no additional file qualifier is  given, then the
  114.                output will be sent to the current working directory. Filenames and extensions
  115.                are ignored  as qualifiers  to this  option. Output  filenames consist  of the
  116.                original filename with the extension '.PCL'. The files can then be transferred
  117.  
  118.                                                 Page 2
  119.                to an hp (or compatible) laser printer using the DOS command 'copy /b src-file
  120.                dest'.  If  duplicate  filenames  are  encountered,  you  will  be  given  the
  121.                opportunity to either over-write the file, replace it or rename it.  In either
  122.                case, you will be forewarned!
  123.  
  124.          Line Numbering (+N<:x>/-N):
  125.                With  this option enabled,  lines can be  numbered from start  of the document
  126.                till EOF is reached. Maximum number of lines supported is 9999, at which point
  127.                we'll wrap around and start from  zero. An arbitrary starting line number  can
  128.                be assigned  the ouptut file using the '+N'  option, e.g '+N:12'. The starting
  129.                page number cannot be saved in the default configuration. If no line number is
  130.                specified i.e. '+N', then the pages that will be printed will have their count
  131.                begin with one from the start of the file. On the other hand, if a line number
  132.                is present, that line number will take effect beginning with the first page to
  133.                be output.
  134.  
  135.          Line Wrap (+/-W):
  136.                Disabled: Line will be truncated to a maximum of 80/95 characters.
  137.  
  138.                Enabled: When enabled,  linewrap will  attempt to  break a line  on a  natural
  139.                boundary, i.e.  on detection of  white space, comma, period  etc. Occasionally
  140.                this may  lead to  a complete line  being wrapped.  Anyhow, wrapped  lines are
  141.                flagged on the printout by '>>' characters.
  142.  
  143.          Copies (+C:xx):
  144.                Using  this option will allow the printer to  make a specific number of copies
  145.                of the source file.  This takes the  burden off the program  and shifts it  to
  146.                firmware in the Laserjet.
  147.  
  148.          Tab Size (+T:xx):
  149.                This  option defines  how tabs  will be  expanded during  printing.  The value
  150.                may have to be altered depending on how the source document was formatted.
  151.  
  152.          Default Font(+DF:x):
  153.                Depending on your  needs, and  the quality  of your eyesight,  two choices  of
  154.                fonts are available for use in  generating the output copy. By default,  the 8
  155.                Pt font is used  by this program. This font is resident in  the printer in the
  156.                form  of  firmware, i.e.  hardcoded  and  burned into  EPROM  and  yields very
  157.                readable  characters that also look good. The alternative  font is a 6 Pt font
  158.                that will cram approximately  20% more text on a sheet of paper  than the 8 Pt
  159.                font.
  160.  
  161.          Lines-Per-Page (+L6/8:xx):
  162.                This value specifies the maximum number of lines that will  be output from the
  163.                given  source file  to each  page of  output. Each font  has it's  own default
  164.                specified; '+L6:xx' is used  to set the default for the 6 Pt font and '+L8:xx'
  165.                for the 8 Pt font.  If the output header is disabled, an  additional two lines
  166.                can be printed  for every page output, e.g.  max lines/page for the  6 Pt font
  167.                can be  82 and for the 8 Pt font it can be 68. If the lines/page and the 'Hdr'
  168.                option conflict, the program will warn the user.
  169.  
  170.          LJ Model (+M:x):
  171.                Identifies  type of printer attached to computer.  This is used in conjunction
  172.                with the 'Duplex Print' option.
  173.  
  174.  
  175.                                                 Page 3
  176.          Duplex Print (+/-D):
  177.                Depending on the laserjet model chosen for the 'LJ Model' option, this feature
  178.                will either automatically print duplex pages at the printer (IID/IIID) or will
  179.                request user intervention to manually feed the initial printed pages back into
  180.                the printer (II, IIP, III, IIIP). When manually feeding the paper, the program
  181.                will specify the orientation of the page for the given binding.
  182.  
  183.          Binding Edge (+BS/+BL):
  184.                Valid only during duplex printing.  Specifies orientation of the text relative
  185.                to opposing face.
  186.  
  187.          Kill (Delete) File after Printing (+K):
  188.                If the file you print is to  be disposed of, you can let the program do it for
  189.                you. By invoking  the +K(ill)  option, the  file will be  deleted right  after
  190.                printing. If this option is  in effect, and the user aborts  the printing, the
  191.                file will not be deleted.
  192.  
  193.          Print Hdr/Pg (+/-Hdr):
  194.                If a header is desired to be printed  for each page output, this is the option
  195.                to set.  The output format  is set by option  '+Hf:x' (see below).  While this
  196.                option is in effect, a  max of 66 lines/page can be printed for  the 8 Pt font
  197.                and 80 lines/page for the 6 Pt font. With the options disabled, the max number
  198.                of lines/page increases by two lines.
  199.  
  200.          Hdr Fmt Style (+Hf:x):
  201.                Sets the header style  in the printed output.  The choice is in the  manner in
  202.                which page numbers are printed. These  numbers can be printed as 'Page xx'  or
  203.                as 'Page x of y'. Naturally the second choice will cause an additional pass to
  204.                be made through the source file in order to get the page count.
  205.  
  206.          Flag Empty Pg (+/-F):
  207.                If  an  empty page  is encountered  in  printing, this  option allows  you the
  208.                ability to flag  that fact. When active it will print 'THIS PAGE INTENTIONALLY
  209.                LEFT BLANK' on all empty pages, otherwise it will do a page eject.
  210.  
  211.          Get Pg Cnt/Print Sel Pg(s):
  212.                Five different variations on this option are available:
  213.  
  214.                +Pg      -> will get the page count for the specified file(s)
  215.  
  216.                +Pg:x    -> will print the specified page for the file(s)
  217.                      (+Pg:x-x will accomplish the same thing)
  218.  
  219.                +Pg:x-   -> will print pages starting with page 'x' to END-OF-FILE.
  220.  
  221.                +Pg:x-xx -> print pages in the range of 'x' to 'xx'
  222.  
  223.                +Pg:-xx  -> print pages starting with the BEGINNING-OF-FILE to Pg 'xx'.
  224.  
  225.          Match Date:
  226.                This  is an  additional  qualifier that  can  be used  in  the file  selection
  227.                criteria. This  option allows for file matching based  upon a user input date.
  228.                Files can be selected relative to  this date, i.e. equal to target date,  less
  229.                than the target date, etc. The command option format is:
  230.  
  231.  
  232.                                                 Page 4
  233.                                  +Md[:qualifier][date]
  234.  
  235.                            Qualifier                           Date Format
  236.                      NULL    -> match date               NULL  -> use current date
  237.                      Lt, Gt, Le, Ge perform the                 else use
  238.                            functions implied             MM:DD:YY, MM-DD-YY, MM/DD/YY
  239.  
  240.          Match Time:
  241.                This option has similar consequences to '+Md'. The time parameter of a file is
  242.                matched in a manner similar to 'Md'. In fact the format and all qualifiers are
  243.                identical except for the time specification. In  lieu of NULL, the time format
  244.                is HH:MM for the argument. The time is specified in 24 hr format, i.e. 00:00 -
  245.                12:00 is AM and 12:01 - 23:59 is PM. The command option format is:
  246.  
  247.                                   +Mt[:qualifier][time]
  248.                            Qualifier                           Time Format
  249.                        (same as 'Md' option)            NULL and HH:MM (24 Hr format)
  250.  
  251.          Save Config (+S):
  252.                As this option implies,  it's use will store the current  command line options
  253.                within  the body  of the executable  program. Like  the other options,  it can
  254.                appear anywhere on the command line.
  255.  
  256.          NOTE: If  the starting or ending page numbers are greater than the size of the file,
  257.          only those  pages that  can be printed  will be, else  the document will  be skipped
  258.          entirely.
  259.  
  260.          Source File:
  261.                This is the standard DOS spec of drive\dir\filespec (wildcards okay).
  262.  
  263.          The following options can be saved as defaults:
  264.                      Output Port             Line Numbers            Default Font
  265.                      Line Wrap               Copies                  Flag Empty Pg
  266.                      Tabsize                 Lines/Page              PrintHdr
  267.                      LJ Model                Duplex Print
  268.                      Binding Edge            Hdr Fmt Style
  269.  
  270.                Because this program  modifies its executable image when configuration changes
  271.          are  saved to disk, any anti-virus programs that  are monitoring the activity of the
  272.          disk may have a conniption. To avoid this, either disable this anti-virus feature or
  273.          else tell the program to ignore it.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.                                                 Page 5
  290.             -------------------------------------------------------------------------------
  291.                                    ZenWare's HP Laserjet Utility Pgm                          
  292.                                              LJPRINT v2.05                                  
  293.                         Print up to four ASCII text pages on one sheet of paper             
  294.                   (For use with HP Laserjet II, IID, IIP, III, IIID and compatibles)        
  295.                                                                                             
  296.             USE : ljprint <input file> <args>                                               
  297.                                                                                             
  298.                    Defaults:                        Options:                     Args:      
  299.              Output Port     : LPT1      x = PRN, COM1, COM2, COM3, COM4,         +P:x     
  300.                                                  LPT1, LPT2, LPT3
  301.                    To temporarily redirect output to a file                    +O<:dest>    
  302.                                   '+O' ->  will write file to current directory             
  303.                              '+O:drv:' ->  will write file to drive 'drv:'                  
  304.                         '+O:drv:\dir\' ->  will write file to path 'drv:\dir\'              
  305.              Line Numbers    : OFF                 ON(1:9999)/OFF                +N<:x>/-N  
  306.              Line Wrap       : OFF                     ON/OFF                      +/-W     
  307.              Copies          : 1                        1:99                       +C:xx    
  308.              Tabsize         : 8                        1:12                       +T:xx    
  309.              Default Font    : 8 Pt         6 = 6 Point     8 = 8 Point           +DF:x     
  310.               Lines/Page(6P) : 80  (95 char cols)       5:80                      +L6:xx    
  311.               Lines/Page(8P) : 66  (80 char cols)       5:66                      +L8:xx    
  312.              LJ Model        : II,IIP,III   0 = II,IIP,III    1 = IID,IIID         +M:x     
  313.              Duplex Print    : OFF                ON(IID,IIID)/OFF                 +/-D     
  314.               Binding Edge   : SHORT                 SHORT/LONG                   +BS/+BL   
  315.              Delete File after Printing: OFF             ON                        +K       
  316.              Print Hdr/Pg    : Yes                     Yes/No                     +/-Hdr
  317.                Hdr Fmt Style : 'Page x'           0 = Pg x     1 = Pg x of yy      +Hf:x    
  318.              Flag Empty Pg   : No                      Yes/No                      +/-F     
  319.              Get Pg Cnt/Print Sel Pg(s):                                                    
  320.                    Default:  Print Pgs 1-EOF                                                
  321.                                                  Get Pg Cnt                      +Pg        
  322.                                                  Print Single Pg                 +Pg:x      
  323.                                                  Print fm Pg x to EOF           +Pg:x-      
  324.                                                  Print fm Pg x to Pg xx       +Pg:x-xx      
  325.                                                  Print fm BOF to Pg xx         +Pg:-xx      
  326.              Match on Date   : Off                                       +Md<:qual><date>   
  327.               Qualifiers:                           Date Format:                            
  328.                 NULL = exact match               NULL = current date                        
  329.                 LT   = less than <date>              otherwise                              
  330.                 GT   = greater than <date>             MMDDYY                               
  331.                 LE   = less than or equal <date>      MM-DD-YY                              
  332.                 GE   = Greater than or equal <date>   MM/DD/YY                              
  333.              Match on Time   : Off                                       +Mt<:qual><time>   
  334.                Qualifiers:                          Time Format:                            
  335.                    (see 'Md' option)             NULL = current Time                        
  336.                                                      otherwise                              
  337.                                                  HH:MM (24 Hr clock)                        
  338.                                                                                             
  339.             Example : ljprint +p:com1 +w file.txt                                              
  340.                  (send 'file.txt' to printer port 'COM1' and wrap the output text)          
  341.             -------------------------------------------------------------------------------
  342.                                                   Figure 1
  343.  
  344.                                                  Help Screen
  345.  
  346.                                                    Page 6
  347.                                                   Examples
  348.  
  349.  
  350.             ljprint *.* +n +w +o +md
  351.  
  352.                   -  print all  files  in current  directory  with linewrap  and line  numbering
  353.                   enabled
  354.                   - store output files in the current directory
  355.                   - print only those files whose date stamp is today.
  356.  
  357.             ------------------------------------------------------------------------------------
  358.  
  359.             ljprint +mt:gt12:00 +md:lt1/1/92 *.c +f
  360.  
  361.                   - send to printer all files with an extension of '.c'
  362.                   - flag any empty page as such in the output
  363.                   - for the file to be selected, its file date has to be less than 1 Jan 92 with
  364.                   a time stamp greater than 12PM.
  365.  
  366.             ------------------------------------------------------------------------------------
  367.  
  368.             ljprint c:\text\*.txt +pg +n +k
  369.  
  370.                   -  generate a  page  count, with  line  numbering enabled,  for  all files  in
  371.                   directory 'c:\text\' with an extension of '.txt'.
  372.                   - delete the files after printing successfully
  373.  
  374.             ------------------------------------------------------------------------------------
  375.  
  376.             ljprint +o:c:\temp abc*.* +w +df:6
  377.  
  378.                   - print all files in the current directory that match 'abc*.*' filespec
  379.                   - enable line wrap
  380.                   - use 6 point font
  381.                   - store output files in directory 'c:\temp'
  382.  
  383.             ------------------------------------------------------------------------------------
  384.  
  385.             ljprint test.jnk +n +pg:13
  386.  
  387.                   - print page thirteen of file 'test.jnk'  with line numbers referenced to page
  388.                   one and starting with number one.
  389.  
  390.             ------------------------------------------------------------------------------------
  391.  
  392.             ljprint test.jnk +pg:13 +n:120
  393.  
  394.                   - print page thirteen of file  'test.jnk' with output line numbering beginning
  395.                   with number 120 as first line number on the page.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                                                    Page 7
  404.                                      LJPRINT.EXE v2.05 Registration Form
  405.                                     *** Please Type or Print Clearly ***
  406.  
  407.  
  408.  
  409.  
  410.                      Name:_____________________________________________________________
  411.  
  412.                      Address:__________________________________________________________
  413.  
  414.                              __________________________________________________________
  415.  
  416.                      City/State:_______________________________________________________
  417.  
  418.                      Zip/Postal Code:__________________________________________________
  419.  
  420.                      Country:__________________________________________________________
  421.  
  422.  
  423.  
  424.  
  425.                      Comments:_________________________________________________________
  426.  
  427.                      __________________________________________________________________
  428.  
  429.                      __________________________________________________________________
  430.  
  431.                      __________________________________________________________________
  432.  
  433.                      __________________________________________________________________
  434.  
  435.                      __________________________________________________________________
  436.  
  437.                      __________________________________________________________________
  438.  
  439.                      __________________________________________________________________
  440.  
  441.                      __________________________________________________________________
  442.  
  443.  
  444.                         Cost (U.S. Funds): $10.00 (NO Credit Cards)
  445.  
  446.                         Mail to: ZenWare
  447.                                  4795 Creaser Rd
  448.                                  Westmoreland, N. Y.
  449.                                  13490
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                    Page 8